home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / util / cli / lookname22.lha / LookName / LookName.doc < prev   
Text File  |  1995-10-24  |  12KB  |  414 lines
  1.                                       
  2.       __      ____  _____________   ___________________________      __
  3.       \\\     | ¼|::|   ¼|   ¼| ¼|::|    ¼|    ¼|      ¼|    ¼|     ///
  4.        \\\    |  |::|  | |  | |  |»»|  |  |  |  |  | |  |   __|    ///  
  5.        ///   .|  |::|  | |  | |     |  |  |  _  |  | |  |   __|.   \\\
  6.       ///   ::|  |»»|____|____|__|__|__|__|__|__|__|_|__|     |::   \\\
  7.       »» ..:::|_____|::::::::::::DOC V2.2:::::::::::::::|_____|:::.. »»
  8.                 :        :                        :  :        ╖  
  9.                 ╖        :                           ╖ 
  10.                          ╖
  11.  
  12.                    Copyright ⌐1994-95 by Philippe Muhlheim.
  13.  
  14.  
  15.  1. Introduction 
  16.     »»»»»»»»»»»»
  17.    Have you ever seen files in your hard disk or floppy disk which look
  18.    like this ?
  19.  
  20.       mOd.inTRO1a
  21.       MOD.final score
  22.       mod.CYBERTORICA
  23.       bad-gokuh.crisis
  24.       buGtrAcE
  25.       SYSTEM-COnFIgUration
  26.       swiSS20
  27.       ...
  28.  
  29.    LookName changes minuscule and majuscule letters of all your files.
  30.    For exemple, you can put the first letter in majuscule and all the
  31.    others letters in minuscule.
  32.  
  33.    You can find some new options in this version of LookName. 
  34.  
  35.   DISCLAIMER 
  36.   »»»»»»»»»»  
  37.  The author is not responsible for any loss of data, damages to software
  38.  or hardware that may result directly or indirectly from the use of this
  39.  program.The author reserves the right to make changes to the software or
  40.  documentation without notice.
  41.  
  42.  
  43.  
  44.  2. How to use
  45.     »»»»»»»»»»
  46.     LookName works only with a CLI, via DOpus is more useful !
  47.  
  48.  ╖) Usage
  49.     »»»»»
  50.      LookName [-<options>] <symbols> [<File> <..> <..>/!]
  51.  
  52.   EX LookName -abcdef... >.=/+ mOd.inTRO1a.xpk (you can write mod.intro1a.xpk)
  53.   »»
  54.      mOd.intRO1a.xpk will be renamed with the following options:
  55.  
  56.  
  57.  ╖) Options
  58.     »»»»»»»
  59. ╗  -a : Kill prefix 
  60.    »»»»»»»»»»»»»»»»
  61.    The prefix of a filename will be cut.
  62.  
  63.    EX Lookname -a mOd.inTRO1a.xpk
  64.    »» mOd.inTRO1a.xpk -> inTRO1a.xpk
  65.  
  66.  
  67. ╗  -b : Kill suffix
  68.    »»»»»»»»»»»»»»»»
  69.    The suffix of a filename will be removed.
  70.  
  71.    EX Lookname -b mOd.inTRO1a.xpk
  72.    »» mOd.inTRO1a -> mOd.inTRO1a
  73.  
  74.  
  75. ╗  -c : Change prefix to suffix
  76.    »»»»»»»»»»»»»»»»»»»»»»»»»»»»
  77.    The prefix of a filename will be put behind the name.
  78.  
  79.    EX Lookname -c mOd.inTRO1a.xpk
  80.    »» mOd.inTRO1a.xpk -> inTRO1a.xpk.mOd
  81.  
  82.  
  83. ╗  -d : Change suffix to prefix
  84.    »»»»»»»»»»»»»»»»»»»»»»»»»»»»
  85.    The suffix of a filename will be put in front of name.
  86.  
  87.    EX Lookname -d mOd.inTRO1a.xpk
  88.    »» mOd.inTRO1a.xpk -> xpk.mOd.inTRO1a
  89.  
  90.  
  91. ╗  -e : Swap prefix <-> suffix
  92.    »»»»»»»»»»»»»»»»»»»»»»»»»»»
  93.    Prefix & suffix will be swapped.
  94.  
  95.    EX Lookname -e mOd.inTRO1a.xpk
  96.    »» mOd.inTRO1a.xpk -> xpk.inTRO1a.mOd
  97.  
  98.       Lookname -e mOd.inTRO1a
  99.       mOd.inTRO1a -> inTRO1a.mOd
  100.  
  101.  
  102. ╗  -f : Make first letter uppercase
  103.    »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»
  104.    The first character must be a letter if not, it will not be changed.
  105.  
  106.    EX Lookname -f mOd.inTRO1a.xpk
  107.    »» mOd.inTRO1a.xpk -> MOd.inTRO1a.xpk
  108.  
  109.  
  110. ╗  -j : Kill space 
  111.    »»»»»»»»»»»»»»»
  112.    All spaces in a filename will be removed.
  113.  
  114.    EX Lookname -j "mOd.   inTRO 1a.xpk"
  115.    »» mOd.   inTR O1a.xpk -> mOd.inTRO1a.xpk
  116.  
  117.  
  118. ╗  -k : kill symbols
  119.    »»»»»»»»»»»»»»»»»
  120.    All symbols in a filename will be suppressed.
  121.  
  122.    EX Lookname -k # mod.## Destruction ##
  123.    »» mod.## Destruction ## -> mod. Destruction
  124.  
  125.  ╖╗  -k1 : Kill symbols and space before and after the symbols
  126.      »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»
  127.    EX Lookname -k1 # mod.## Destruction ##
  128.    »» mod.## Destruction ## -> mod.Destruction
  129.  
  130.  NOTE! The k option can't be used with the s option.
  131.  
  132.  
  133. ╗  -l : Change space to "_" 
  134.    »»»»»»»»»»»»»»»»»»»»»»»»
  135.    All spaces will be changed by "_" symbol.
  136.  
  137.    EX Lookname -l mOd.inTRO 1a.xpk
  138.    »» mOd.inTR O1a.xpk -> mOd.inTRO_1a.xpk
  139.  
  140.  
  141. ╗  -o : Change "_" to space
  142.    »»»»»»»»»»»»»»»»»»»»»»»»
  143.    All "_" symbols will be changed by spaces.
  144.  
  145.    EX Lookname -o mOd.inTRO_1a.xpk
  146.    »» mOd.inTR_O1a.xpk -> mOd.inTRO 1a.xpk
  147.  
  148.  
  149. ╗  -n : Put a capital letter after a number
  150.    »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»
  151.    Lookname looks into a filename and if there is a or several numbers,it
  152.    puts a capital letter after this number.
  153.  
  154.    EX Lookname -n mOd.inTRO1a.xpk
  155.    »» mOd.inTRO1a.xpk -> mOd.inTRO1A.xpk
  156.  
  157.  
  158. ╗  -i : Put a capital letter after a space
  159.    »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»
  160.    The same effect but after a or several spaces.
  161.  
  162.    EX Lookname -i mOd.i nTRO1a.xpk
  163.    »» mOd.i nTRO1a.xpk -> mOd.i NTRO1a.xpk
  164.  
  165.  
  166. ╗  -g : Filename Amiga 30 characters -> Filename PC 8(+4)
  167.    »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»
  168.    Lookname cuts a filename with max.30 characters (on Amiga) to
  169.    max.8 characters.
  170.    If the filename contains a space, "*", ".","_" all these characters will
  171.    be removed.
  172.  
  173.    EX Lookname -g mOd.inTRO1a.xpk
  174.    »» mOd.inTRO1a.xpk -> mOdinTRO
  175.  
  176.  ╖╗  -g1 : Preserve suffix
  177.      »»»»»»»»»»»»»»»»»»»»»
  178.      It preserves the suffix, only a point and 3 characters.
  179.  
  180.      EX Lookname -g1 mOd.inTRO1a.xpk
  181.      »» mOd.inTRO1a.xpk -> mOdinTRO.xpk
  182.  
  183.  ╖╗  -g2 : Preserve prefix
  184.      »»»»»»»»»»»»»»»»»»»»»
  185.      It preserves the prefix, only 3 characters and a point.
  186.  
  187.      EX Lookname -g2 mOd.inTRO1a.xpk
  188.      »» mOd.inTRO1a.xpk -> inTRO1ax.mOd
  189.  
  190. ╗  -h : Put strange or normal (h1) characters !
  191.    »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»
  192.    Lookname changes normal characters to strange ASCII.
  193.  
  194.    EX Lookname -h mOd.inTRO1a.xpk
  195.    »» mOd.inTRO1a.xpk -> m°d.ín╢r°1σ.╫■k
  196.  
  197.  ╖╗  -h1 : put normal characters
  198.      »»»»»»»»»»»»»»»»»»»»»»»»»»»
  199.      Remove normal characters.
  200.  
  201.      EX Lookname -h1 m°d.ín╢r°1σ.╫■k
  202.      »» m°d.ín╢r°1σ.╫■k -> mod.intro1a.xpk 
  203.  
  204.  
  205. ╗  -m : Use multi-files
  206.    »»»»»»»»»»»»»»»»»»»»
  207.    With this option, you can use several files.
  208.    If the filename contains a space, you MUST use quotes.
  209.  
  210.    EX Lookname -m mOd.inTRO1a.xpk demO2 "DISK. InfO"
  211.    »» mOd.inTRO1a.xpk -> mOd.inTRO1ax
  212.       demO2 -> demO2
  213.       DISK. InfO -> disk. Info
  214.  
  215.  
  216. ╗  -pt : Put the real name of a ProTracker-clone
  217.    »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»
  218.    This is very useful.If you have a protracker file (StarTrekker,Tracker-
  219.    Packer ... or all files that contain the name of the module in the
  220.    header) which is truncated (PC files), Lookname renames the file with the
  221.    20 first characters and puts the prefix "mod".
  222.  
  223.    If the PT-filename contains a or several spaces, before or after the name,
  224.    all spaces will be removed (ex. "mod.   intro1a    " -> mod.intro1a).
  225.  
  226.    EX Lookname -pt 1
  227.    »» 1 -> mod.intro1a
  228.  
  229.  
  230. ╗  s : Use symbols
  231.    »»»»»»»»»»»»»»»
  232.    This is the principle of lookname v1.0. It changes the letters to the
  233.    capital letters after the different symbols e.g. =/-.+=
  234.  
  235.    EX Lookname -s .=/\O mOd.inTRO1a.xpk
  236.    »» mOd.inTRO1a.xpk -> mOD.InTRO1a.Xpk
  237.  
  238.    Don't USE quotes for the symbols, but you can include letters or numbers.
  239.  
  240.  
  241. ╗  r : Make filenames lowercase  (it was the default mode)
  242.    »»»»»»»»»»»»»»»»»»»»»»»»»»»»
  243.    EX Lookname -r mOd.inTRO1a.xpk
  244.    »» mOd.inTRO1a.xpk -> mod.intro1a.xpk
  245.  
  246.  
  247. ╗  u : Make filenames uppercase
  248.    »»»»»»»»»»»»»»»»»»»»»»»»»»»»
  249.    Do you like capital letters ? Yes? Use this option.
  250.  
  251.    EX Lookname -u mOd.inTRO1a.xpk
  252.    »» mOd.inTRO1a.xpk -> MOD.INTRO1A.XPK
  253.  
  254.  
  255. ╗  t : Make alternate upper/lowercase
  256.    »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»
  257.    EX Lookname -t mod.intro1a.xpk
  258.    »» mod.intro1a.xpk -> MoD.iNtRo1A.xPk
  259.  
  260.  
  261. ╗  v : Make negative filename look
  262.    »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»
  263.    EX Lookname -v mod.intro1a.xpk
  264.    »» mod.intro1a.xpk -> mOD.iNTRO1A.xPK
  265.  
  266.  
  267. ╗  A : Rename only prefix
  268.    »»»»»»»»»»»»»»»»»»»»»»
  269.    It renames only the prefix, all the others letters are not changed.
  270.    You can't use B option.
  271.  
  272.    EX Lookname -Au mod.intro1a.xpk
  273.    »» mod.intro1a.xpk -> MOD.intro1a.xpk
  274.  
  275.  
  276. ╗  B : Rename only suffix
  277.    »»»»»»»»»»»»»»»»»»»»»»
  278.    It renames only the suffix, all the others letters are not changed.
  279.    You can't use A option. 
  280.  
  281.    EX Lookname -Au mod.intro1a.xpk
  282.    »» mod.intro1a.xpk -> mod.intro1a.XPK
  283.  
  284.  
  285.  - "q" option looks if you have a PowerPacker suffix, you will get
  286.    ".pp" instead of ".Pp".
  287.  
  288.  - If you don't put any option, all letters will be in minuscule.
  289.  
  290.  
  291.  -) LookName -abcdef[...] =/_.- !
  292.  
  293.    ALL FILES in the current directory will be renamed.
  294.    »»»»»»»»»
  295.  
  296.  
  297. NOTE:
  298. »»»»
  299.   !!!! You can use CTRL+C to *STOP* LookName. !!!!
  300.                    »»»»»»
  301.   All options may be in any order ! 
  302.  
  303.  
  304.  
  305.  3. System requirements
  306.     »»»»»»»»»»»»»»»»»»»
  307.    No need library or device, only your 2 hands í!í 
  308.  
  309.    LookName works successful with:
  310.  
  311.     - OS1.2, OS 1.3, OS 2.x, OS 3.x.
  312.  
  313.     - MC68000,MC68010,MC68020,MC68030,MC68040.
  314.  
  315.     - All HardDrives,PFS,DS1... even ┐DF1?  
  316.  
  317.    If you have any problem for running LookName, go and see the author.
  318.  
  319.  
  320.  
  321.  4. Distribution & Copyrights
  322.  áá »»»»»»»»»»»»»»»»»»»»»»»»»
  323.    This program is copyright (c) 1995 by Philippe Muhlheim.
  324.    You can spread this as long as all the files (unmodified!) are
  325.    included in this archive and no money is involved in the process.
  326.  
  327.    The files that your can find in this archive:
  328.  
  329.     * LookName/
  330.       - LookName.00     4580 bytes   )------------> the 68000  version
  331.       - LookName.20+    4280 bytes   )------------> the 68020+ version
  332.       - LookName.doc   11771 bytes   )------------> Lookname documentation
  333.     * LookName.info
  334.     * Bonus/XFD/
  335.       - 4Vx              580 bytes   )------------> External decruncher
  336.       - readme            61 bytes  
  337.  
  338.  
  339.  5. LookName revision history
  340.    »»»»»»»»»»»»»»»»»»»»»»»»»
  341.  2.2:   Adds/Changes since 2.1 (23-10-95)
  342.       - Make alternate upper/lowercase  (-t) (Hi Eagle ! :^)
  343.       - Make negative filename look     (-v)
  344.       - Rename only prefix              (-A)
  345.       - Rename only suffix              (-B)
  346.       - pt option is now p option !
  347.       - Detect and remove dangerous symbols /:" when it uses p option
  348.       - Try to rename several time a file when there is a identical filename
  349.  
  350.  2.1:   Adds/Changes since 2.03 (12-09-95)
  351.       - Default mode is now an option !  (-r)
  352.       - kill symbols option added.
  353.         ex. mod.## Destruction ## -> mod.Destruction
  354.  
  355.  2.03:  Adds/Chances since 2.02 (16-06-95)
  356.       - Fixed bug : the last letter was killed with pt option, when there is
  357.         a space before this letter ! ( TMG hΘhΘ ;-)
  358.  
  359.  2.02:  Adds/Changes since 2.01 (25-05-95)
  360.       - Fixed bug : the last letter was killed with pt option
  361.  
  362.  2.01:  Adds/Changes since 2.00   (22-05-95)
  363.       - Remove spaces before and after a PT-Filename
  364.  
  365.  2.00:  Adds/Changes since 1.10   (18-03-95)
  366.       - kill prefix , suffix
  367.       - Change prefix to suffix , suffix to prefix
  368.       - Swap prefix <-> suffix
  369.       - Kill space , "_"
  370.       - Change space to "_" , "_" to space
  371.       - Filename AM 30 characters -> Filename PC 8(+4)
  372.       - Put strange or normal characters !
  373.       - Use multi-files
  374.       - Put the real name of a ProTracker-clone
  375.       - Change ".Pp" -> ".pp"
  376.       - Use symbols
  377.       - 68000 and 68020+ versions 
  378.  
  379.  1.10:  Adds/Changes since 1.01 (not released)   (05-03-95)
  380.       - rewritten
  381.       - use less bytes
  382.  
  383.  1.01:  Adds/Changes (not released)   (27-02-95)
  384.       - resourced (HD crash)
  385.       - added "?" -> Lookname ?
  386.  
  387.  1.00:  First public release   (08-09-94)
  388.  
  389.  
  390.    If you find bugs, have ideas of improvements or any suggestions,
  391.    just contact me please, see the author for address.
  392.  
  393.  
  394.  
  395.  6. Future plans
  396.     »»»»»»»»»»»»
  397.  - More options.
  398.  - Interface.
  399.  - Your ╖suggestions╖
  400.  
  401.    LookName is freeware.If you like and use it, please send
  402.    me an original postcard.Thanks!
  403.  
  404.    If you have any suggestions/ideas/bug reports etc.
  405.    Please contact me at the following address:
  406.  
  407.  
  408.         Philippe Muhlheim
  409.         20 Avenue de l'Europe
  410.         67170 Brumath
  411.         France
  412.  
  413. ------------------------------------END-----------------------------------------
  414.